/ 



ATTR Syntax: Attr filename [permissions] Usage : Examine or 
change the security permissions of a file Opts: -perm = turn off 
speci ' 

inhibi 



ge 

f led permission Derm= turn on specified permission -a = 



s - nc 
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pw - 
Synta3 
one d4 
single 
BasicQ 
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CHD S 
specify 

directdry 16 
Usage : 
Usase 
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Creates OS-9 bootstrap 




ayntax 
Syntax 



f.-f 



TT-.^ 



tLm, 



-A.». 



u 



one fil 
Date ft 
specify 
: Checl 
for woi 
= save 
cluster 

!irint i 
<devn 
ilenan 
delete 
directo 

[e] \A 
names 

execut j 

Display s m^mm 



Dsave [^o| 
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rms : d - directory file 
,.^^s:.pwner w - irrite permit 
ii^i read permit to public 
Hf ermit^o public BACKUP 
^pp Copies all data from 
^^^ error occurs s = 
iilites BASIC09 Syntax : 
;^BUILD Syntax: Build 
IB^rom standard input 
working directory to 
sage: Change execution 
nlenamel filename2 
tax: Cobbler devname 
m current boot CONFIG 

^ — ' ■ — * - | i disks COPY 

data from 
feSyntax : 

a: t = 
|iil> Usage 
=^i|ctory 

iifcnused 

ii|:-o = 

iifaame> 

llllel [-x] 

iiiibeldir 
ipax: Dir 
iil file 
x=print 




m Syntax 
iiiiure file 
to copy all files "in a directory system Opts : -b niake a system 
disk by using 0S9boot if present -b=<path> = make system disk 




using pa 
process b 
comman ' 
ECHO Syn 
output E" 

-xw'^;<':':':v:-:-^:-!|f>>:->:v:-:v:-:-:-:-:-?;->:' 

error messag^ ^^.™^^-^....^^ 
Usage: Chain w ta^^s p^^raf 
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makdir 
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^i^ard 
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iiiiiiiipam«> 

<devname> Usage : Initializes an OS-9 diskette Opts ; R - Ready L 



<:devname> usage : miuaiizes an Ub-» msKette upts ; k - Keaay l 
- Logical format only "disk name" 1/2 number of sides 'No of 
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Newsletter of the National 0S9 User Group 



EDITOR i Gordon Bentzen 

HELPERS : Bob Devries and Don Berne 

SUPPORT : Brisbane 0S9 Level 2 User Group. 

Welcome to yet another edition of our newsletter. Boy I These irionths certainly seem to roll around quickly t it must 
be that the months are getting shorter^ it seeiris that lue no sooner CGHiplete one neiDSletter and post it off than ute 
are short of time for the ne>it - again! 

Well after last month's editorial I guess that you do not want any more pleas for material i so I will just get on 
with the good news. 

I am pleased to report that subscription renewals for another twelve Tionths have already begun, all be it slowly 
at this, stage. As stated in our July 1988 edition of this newsletter, we will require at least a iriembership of 
twenty ta justify the effort that goes into production, so please help us by sending your renewal form and 
subscription by the end of August. 

Apology:- The editorial of the June edition included reference to some new public domain software from the U.S.A. 
which was included in that newsletter. Did you have trouble finding it? Well we slipped up last month and did 
not include that material. Sorry. Bob has included his comments on that software in this edition. 

Don has also included the first part of a Tutorial on EDIT, the 0S9 Macro text editor, which will no doubt assist 
many readers. 

If you have been following the Data Base series by Bob Devries (and I hope that you have) you will find some more 
of the 'C' source code by Bob in these pages. 

Phil Frost, a user group member from Kalgoorlie, has been good enough to send a Basir09 procedure to share with us. 
This is a simple programme which demonstrates Ohms law. The source code is included in this edition. Many thanks 
Phil for sharing it with us. 

As a final comment this month 1 must say that '^^e expected last month's editorial to prompt some comments from the 
membership. Very little has been received, in fact no comment would be the most accurate description. 

We are keen to present something that is interesting and hopefully useful, so please drop us a short note and tell 
us what you like and also what you don't like. Perhaps you could make a note or two on your subscription renewal 
form so that we may be able to include something to suit your special interests. 



COCO-LIhK Hagazine: Just a reminder for those interested in a wider section of CoCo systems. CoCo-Link is 
produced in South Australia and is well worth your support. Contact the editor, Robbie Daliell on (08) 386 1647 or 
write? 

CoCo-Link 31 Nedland Cres. PT.NOARLUNGA STH S.A. 5167 

The bi-monthy magazine will cost you $8.00 joining fee plus $12.30 a year subscription. 

Until next month, happy computing. 
Regards, Gordon Bentzen, 
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Phil Frost 

25 Cheetham Street 

KALSOORLIE 6A30 W.A. 

10th June 1?S9 

Dear Gordon & Crew 

Weil I have finally uTitten a programmnieT this is my first effortr I hope you like it. It is an 
educational prograiriroe on OHM'S LAW and can be used to work out values in electronic circuits. The programme is 
written in Ba5ic09i as an executable module in the CMOS directory, OHMS. The source code is the root directory, 
OHMSt and as a list file Ohms.laiif. 

So cheers for now. 

Phil. 
PROCEDURE ohms 
(* ohms law 

(* Phil Frost 20th April 1989 
(* a program to demonstrate OHM'S LAW 
(♦ 

DIM ohms, volts, amps: REAL 
DIM select :STRING[1] 
DIM choice: BYTE 
(* 

ohms:=0 
volts:=0 
amps:=0 
(* 

10 PRINT CHR$(12) 
PRINT 

PRINT TAB(29); "***** OHM'S LAW *****' 
PRINT 

PRINT " When a voltage is applied to a resistive circuit the current in" 
PRINT " amperes will be proportional to the voltage, and mversly proportional' 
PRINT " to the resistance in ohms" 
PRINT 

PRINT TAB(16); "This relationship is represented by the forfiiuias' 
PRINT 

PRINT TAB(14); "E = I k R or I = E / R or R = E / I" 
PRINT 

PRINT TAB(20); "Where E = Volts I = Amps R = Ohm's' 
PRINT 

PRINT TAE(21); ■<!> To find the Current in a circuit ' 
PRINT 

PRINT TAB(21}; "<2> To find the Resistance of a circuit " 
PRINT 

PRINT TAB(21}; '<3> To find the Voltage in a circuit " 
PRINT 

PRINT TAB(21)', "<4> Quit " 
PRINT \ PRINT 

PRINT TAB(21); ' Select: •; \ INPUT choice 
ON choice GOTO 100,200,300,400 
100 PRINT CHR$(12); 
ohm5;=0 
volts:=0 
afhps:=0 
PRINT \ PRINT \ PRINT 



Page 3 



AUSTRALIAN 0S9 NEWSLETTER 

PRINT " To find the Current (amps) in a circuity inhere the Ohms and Volts are known" 

PRINT \ PRINT 

PRINT TAB(35); "E = I / R " 

PRINT \ PRINT 

PRINT TABi20); 'Where E = Volts I = Amps R = Ohifi's" 

PRINT \ PRINT 

INPUT " Enter the resistance in Ohms :',chms 

PRINT \ PRINT 

INPUT ' Enter the Voltage :% volts 

PRINT \ PRINT 

anjps=volts/ohins 

PRINT ■ The Current in the circuit isM 

PRINT USING •r3.2'iaff.ps; 

PRINT ■ Araps : ' 

PRINT \ PRINT 

PRINT ■ <A>nother or <M>enu "; 

INPUT select 

IF 5Blect='a' OR 5elect="A' THEN 

GOTO 100 

ELSE 

IF select='in" OR 5elect='M" THEN 

ENDIF 

ENDIF 

GOTO 10 

290 PRINT CHR$(12) 

ohfris:=0 

volts:=0 

ainp5:=0 

PRINT \ PRINT \ PRINT 

PRINT " To find the resistance in a circuity where the Voltage and Amperage are known ' 

PRINT \ PRINT 

PRINT TAB(35); "R = E / I ' 

PRINT \ PRINT 

PRINT TAB(20); "Where E = Volts I = Amps R = Ohms" 

PRINT \ PRINT 

INPUT ■ Enter the Current in Amps : Samps 

PRINT \ PRINT 

INPUT ■ Enter the Voltage i S volts 

PRINT \ PRINT 

ohms=volt5/amp5 

PRINT ■ The Resistance in the circuit is : '; 

PRINT USING "r8.2'tDniris; 

PRINT ■ Ohnis ' 

PRINT \ PRINT 

PRINT " <A>nDther or <M>enu S \ INPUT select 

IF select="a" OR seIect="A" THEN 

GOTO 200 

ELSE 

IF select=*'m' OR select='M' THEN 

ENDIF 

ENDIF 

GOTO 10 

Dhms:=0 

volts:=0 

ainps:=0 

300 PRINT CHR$a2) 

PRINT \ PRINT \ PRINT 
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PRINT ■ To find Voltage in a circuity liihere the Resistance and Current are knoiiin" 

PRINT \ PRINT 

PRINT TAE';35); "E = I >i R " 

PRINT \ PRINT 

PRINT TAB(20); "Where E = Volts I ^ Amps R = Ofms' 

PRINT \ PRINT 

INPUT ' Enter the rpsistance in Ohnis : "lohms 

PRINT \ PRINT 

INPUT ■ Enter the current in Afiips : %d,TiPS 

PRINT \ PRINT 

volts=aiiip&*ohn!5 

PRINT " The Voltage in the circuit is : "? 

PRINT USING ''r8.2%voit5; 

PRINT « Volts ■ 

PRINT \ PRINT 

PRINT " <A>nother or <H>enu % \ INPUT select 

IF select^-a" OR 5Plect="A" THEN 

GOTO 3013 

ELSE 

IF 5elect=*'m' OR £eiect="H^ THEN 

ENDIF 

ENDIF 

GOTO 10 

400 END 

ggooooooooOOOOOOOOOOgggodddgog 

EDIT : A tutorial on the OS-9 Macro Text Editor 

The OS-9 editor is a powerful but easy to use text editor. Some of it's features are sifiall sizei multiple buffers, 
and edit macros. The editor occupies only 5K of fftemoryT leaving plenty of space for large text files. The editor 
requires at least 2K of free RAM to run. The editing of irtore than one file at the same time can also be undertaken 
since it allows the creation of 2 or more buffers. And you can create macros that let you customise the editor for 
personal use. All 05-9 shell commands are usable inside the text editor, and files larger than the buffer can be 
successfully edited. 

After using EDIT you will find that there are a few coffimands that you will use Kore frequently than others. Here 
is a list of the ones that the majority of users find most useful. 



^ Cor 


<ctrl: 


>+73 


move to start of text 


/ 






move to end of text 


+n 






move forward n lines 


-n 






move backward n lines 


Cn SI S2 




replace SI with S2 n times 


Dn 






delete n lines 


En SI 






extend n lines with SI 


Sn Si 






search for n occurrences of Si 


Ln 






list n lines 


Q 






quit 



This is a very small list of the possible commands that can be used with EDIT. In general, n is a number; leaving 
it out of the command implies 1. if an "*" is used instead of n, then the number is the largest possible integer 
(65535 in an 8 bit system). Si and S2 are any string that you wish to use. They are always delimited with some 
character. It doesn't matter what the character is, as long as it is used throughout the cofTusand line. When any 
of the above commands are used, the edit pointer is left at the beginning of the target line. The exception is 
"/% which leaves the pointer after the last line. 
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To start the editor, type : 

EDIT filenanfel [filenarr.e2 #nK] 

If filenamel eMistsi a teriporary file nairted SCRATCH (yes, it is in upper case) niiii be created. On terrrdnatiDn of 
an edit session, the original uill be deleted^ and SCRATCH will be renaiTfed. Vou msi have DEL and RENAME in rrterriory 
or your execution directory. In order to successfully edit a file, the file read and write attributes need to be 
set. If filenaiTiel does not exists it yill be created. If frienai[ie2 is specified, the original file is not 
modified, and the newly edited file will be named filenairse2. The '^nK" is the standard OS-9 rrteinory allocation 
modifier. If no memory size is- specified, then 8K (the systefii default) will be used. The editor prints a prcmpt 
m much the same manner as OS-?. It prompts luith: 



The editor assumes that any character in position 1 of a line signifies the start of a command string. A space in 
position 1 tells the editor that what folloius is to be inserted as a new line. If the editor cannot interpret a 
command, or the command is not legitimate, the editor responds withi 

WHAT? 

One of the most common causes of this response stems from neglecting to start a new input line with a space. I 
norfffally use only a few commands to move through the text. Armed with +n and -n, I can get anywhere. The '^ and / 
are also convenient to move to the beginning and the end of the te>a buffer. These can be duplicated by +* and -*, 
however, in a large textfile, these alternatives ar^B quite a bit slower. The +* and -* appear to move through ail 
of the textlines, while the ^ and / go directly to their respective destinations. Nevertheless, the effect is the 
same. When using any of the movement commands, the imaginary edit pointer is moved to some particular line. If 
you've used only line number oriented editing this may take a little getting used to. Most people find it easy to 
use after some practice. To search for a particular te>it string, use S. That is, to search for the string "hello 
there!', enter: 

E:S/hello there!/ 

The edit pointer will stop at the beginning of the line in which the first match is found. Remember, the match 
must be exact. The editor will distinguish between upper and lowercase. Placing a number after the S will cause 
it to search for that number of occurrences of the target text, 

E:S5;hellD there!; 

will pass over the target string A times, displaying the line each time, and stop at the beginning of the fifth 
line containing the target string. Notice the differing delimiters used to mark the string in each example. The 
only requirement is that delimiters are the same, on each individual coBimand line. The command: 

EsSstrings 

uould search for the target string "tring", as the delimiter in this instance is s. The C command is used to alter 
the target string to a specified replacement string. For example, to change the occurrence of "the" to "this" for 
the next three instances, we could enter: 

E:C3!the!thi5! 

Here the ! delimits the strings. Any other character could be used, so long as we are consistent, A variation 
which can be used to delete occurrences of words is: 

E:C3.yes.. 

This would remove the next three occurrences of yes. 



Page 6 



AUSTRALIAN OS9 NEWSLETTER 

The reverse can also be used: 

E:C::10: 

would insert 10 at the beginning of the line. Above» when me discussed the most used commandST ue mentioned the E 
command. This cofTiinand extends the current line with the delimited te>;t. It is especially handy when commenting 
programme listings, and with a little experience, becoffjes an extremely fast may of commenting your code. The L 
command is used to list parts of your te>;t. 

E:L12 

mill list the next 12 lines of text starting at the current edit pointer location. The edit pointer does not 
change position. Using L without a number suffi>; will list the current line, and this is an easy way to determine 
on mhich line the edit pointer is situated. The last of our most used commands is the D command. D will delete 
lines starting from the position of the edit pointer. To remove 3 lines use: 

E:D3 

To delete text from the current pointer position to the end of the buffer^ use the * modifier. Comrrtands can be 
chained together. As long as the start in the first column? they can be entered on 1 line. The following command? 
for example: 

E:H3C2/Yes/No/ 

moves the pointer to the top of the buffer, moves down 3 lines, and then changes the next 2 occurrences of Yes to 
No. You should perhaps think twice about using the following: 

When finishing an editing session, enter Q. The buffer will be written out to the file. Any existing file will be 
deleted if necessary, and the SCRATCH file mill be renamed to the oldname. If things should go awry, you could 
find that you are left with a file named SCRATCH, and you mill have to do some deleting and renaming of your own. 
In this article, all coffimands have been presented in upper case to make them more easily readable. This is not 
necessary, and could just as well have been in lower case. These simpler commands pertaining to the editor are 
very similar to those of the BASIC09 editor. This is only a sriiali smattering of what can be done with the OS-9 
editor, and many things have not been covered. For example, there are 34 comfnands and 26 pseudo macros in the 
macro commands section of the editor. It is possible, of course, to create you own macros, and we hope to be able 
to present an article on this in the near future. 

ooooooooooOOOOOO(»000(»oooooooooo 

The Public Domain Library. 
A Review by Bob Devries. 

The National 0S9 Usergroup public domain library has recently been augmented by the addition of some 
programmes and other files from the Compu-Serve CtS9 Forum in the United States. They came to us by courtesy of Mike 
Harris of Sydney. 

In this review I will briefly cover the contents of the 34 archived files that Hike sent me (Thanks Mike 
III). I have unarchived all the files and they now take up one full 88 track double sided disk and about a third of 
another. All of the files mere archived using the programme 'AR09' which is also available in the public domain 
library. Quite a lot of the files are actually patch files, including soiije for use with MODPATCH and some others 
for use with a prograinme called IPATCH. This is a specially written patching programme which includes the facility 
to insert code into a file, which is something MdDPATCH cannot do. 



F'age 
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Now I uiill cover each archive file in turn and discuEB iiE contents, 

ALIE 

This is a library of routines for ffiachine code prograiiiRiers (and probably C also) which has been written 
in the format necessary for RHA to use. It comes complete with document files. Written by Bob van der Poei. 

BUSS 

This is a te>;t file which discusses several bugs which have been found in the 0S9 level 11 system 
filesT and details how to patch them. It was written by Kevin Darlingi and was the subject of one chapter in 
his book Inside 0S9 level II. 

CC 

This is the C source code for a new 'front end' for the Microware C Ccffipiler. It replaces CCi. It is 
complete with the source code (in C of course) and documentation. Written by Eiil Dickhaus. 

CC3DISK 

This is a patch file for the CCSDisk driver programme to alloui the user to read foreign format disks. 
Author unknown. Document files included. 

CHOOSE 

Here's a little beauty which a lot of people will probably find useful. Amongst other thingst it has 
the ability to display all the files in the current directory and allows you to choose them one at a time to 
pass their names to a particular command. It is mouse driven? and written in C. Source and docs provided. 
Written by Stephen Clark. 

CLIES 

These files are a new C standard library written by Karl Kreider to replace the standard library 

(Clib.l) on the Microware C Compiler. Two versions are provided? one includes the transcendental maths 

functions. The documents ^re extensive and written by Hark Griffith (SLED author). 

CPATCH 

A patch file to allow the C Compiler to use the RHA assembler and the RLINK linker from the Development 
System. Author unknown. 

DATAHO 

Datamod by Ron Lammardo is a programme to convert shellscripts to files which are able to be loaded 
into memory. Includes doc files. 

EDCON 

An Icon Editor by Toby Farley. Uses the Multi-Vue environment with pull-down menus etc. Includes doc 
files and aif file and icon. 



FUNK 

File Link allows a file to have a directory appearance in more than one directory. By K.R.HcHurdc. 
Includes doc file, 

FORKSH 

Forks a shell if a key is pressed within a user selectable time limit. Useful for in startup files. By 
Pete Lyall. Includes manual and help file. Written in C, and includes source. 

GFRHAT 

Graphic Format is a front-end programme for the normal FORMAT to pretty it up for use with Hulti-Vue. 
By Mike Haaland, Includes docs, and source in C. 
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GSHEL2 

Version 1.24a of Kent Meyers' patcl-f for the Multi-Vue GSHELL progranime. Good increase in speedi and 
includes so/iie nice extras. This archive is ffiostly files with a .ipc extension which means that they are for use 
with IPATCH. Doc file included. 

SShELL 

Version 1.24 of Kent Meyers' patch for Hulti-Vue GSHELL prograniirfe. You'll need this one before the 
version above. Several other programmes are included in this archive including a directory sort for Multi-Vue. 

5SHPAT 

A patch for a patch. This one patches the patched GSHELL and allows Multi-Vue to start in 80 column 
mode. Also supplied with an alternate font set. Docs included. This one is by Mike Haaland. 

HDMAKE 

This one is a utility for assembly language programmers for easing the use of RMA and RLINK, By Ron 
Lammardo. Includes assembler source and short doc file. 

HEADER 

This archive contains 25 C header files a lot of which are not included with the C Compiler. Author 
unknown. Files are all in C source of course. 

HELV 

This archive contains a 'Helvitica' style text font, and includes an icon and aif file to start a shell 
in Multi-Vue with the new font. Small doc file included. Author unknown. 

ICONS 

Here are 16 different icons for various different programmes (some of which Tve never heard of !) with 
their respective aif files. Great for ideas on how to set up your own applications under Multi-Vue. Author 
unknown! but a sisal 1 readme file included. 

IPATCH 

Here's the archive you'll need to do soirre of the fancier patches including Kent Meyers' GSHELL patch. 
This one is quite complexi but includes full docunientation. It also includes a patch file for converting 
PRINTERR from the level one 0S9 to work with level II. Written by R.M*Santy. 

HV2PAT 

Various IPATCH files for system modifications including Windint, CC3I0 and GPort. By Kent Meyers, 
includes documentation, 

MVDEMO 

Demonstration programme for use with Multi-Vue including icons etc. Includes C source and document 
files. By Toby Farley. 

riVSKEL 

A skeleton programme for C programmers to use for applications programmes for Multi-Vue. Source and 
docs provided and written by Mark Griffith. 

MVTEST 

A Basic09 programme written by Kevin Darling for testing out the functions of Multi-Vue, Also useful to 
see how it's done. No documentationi but source code is commented. 

09GIF 

Here is a graphics utility for 0S9, It allows you to transfer pictures encoded in GIF file format and 
display them on the colour computer screen. So those people with ColorMax can transfer pictures froffi RSDOS to 
0S9. I have been able to transfer pictures from my Commodore Amiga to 0S9 and display them. Documents and 

icon/aif files included. By Chris Babcock. 
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PLAY 

A prograiTiiTie for pieying on the CqCc's speakeri flies fron the Apple Macintosh or Amiga which were 
digitized by those coniputers. Includes a sample file and sparse docutiientatiDn. Possibly written by Kevin 
Darling, but TiTi not sure, 

RSDOS 

For those of you mho use both RSDOS and 0S9, and use SDiskS* here's a utility that uali elloiL' you to 

transfer- files straight to and froir! an RSDOS disk. It even works on 35 track RSDOS disks in an 8S track 0S9 

drive! Author unknomni but this progrartime coffies included in the package luith the CRC-Disto Super Controller II. 

Fixes and ffiods to the 3CF irianager prograirtiTie under level II OS? to aHo»±s line recalling AND editing. 
Includes docuuients. and is niritten by Kevin Darling. 

SCRIPT 

Details and exair.-pies on how to set up script files for use with Shsllplus. Great stuff ! By Steve 
Clark. 

SHELL21 

Version 2.1 of Shellplus including all the fiiodpatch files for enabling sofue of the options. Includes 
complete (long) docufffentation. Written by Ron LanhTiardo. 

SSCRIP 

More samples of how to use script files with Shellplus by Steve Clark. 

TFLICONS 

A few ffiore (9) icons and their aif files for using various programfffes under Multi-Vue. By Brian 
Stretch. Readme file included. 

VDD 

Modifications to the rantdisk supplied with the Developnient System. Programme by Volney La Rowe. Readme 
file included, I PATCH needed for this one. 

WINVD5 

Various assembler files and mods for window device descriptors using the VDG (32X16) screen with 
Windint or Srflnt. Docs included. Written by Bruce Isted, 

Well* that's all for now, if you feel you absolutely must have some of these archives^ they are available 
in the usual way from the National 0S9 User Group, As I saidi this lot altogether takes up two 88 track disks^ and 
of course a lot oiore in the less dense formats. 

Regardsi 
Bob Devries. 

ooooooooooOOOOOOOOOOooooooooDo 



The 0S9 Operating Syste» 

It seems that some users of MicrcwajfaOS? Level 1 on a Tandy CoCo system are still using single sided 35 track disk 
format. If you have disk drives capable of A0 track single sided or 40 track double sided you can configure 0S9 to 
fully utilise such capability. The "standard" versions of Mi crov/are, Level 1 0S9 as distributed by Tandy for the 
CoCo did not provide for such drives, however there are various means of modifying the operating system to achieve 
the desired result. 
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The main problem is that the disk drivert CCDiski for the CoCo is hard coded for 35 track single sided drives. 
Further, this driver does not look at the device descriptors DB, Dl, D2, D3 for track count, number of sides or 
head step rate. So this means that both the device driver, CCDisk and also the descriptors D0, Dl etc.t need to be 
patched. 

Noujt as I have codBftented in earlier articles? 0S9 makes frequent use of disk access to load modules into aemory 
Those accustomed to loading an R.S. Dos programme from disk and then running or executing it, will no doubt notice 
the difference under 0S9. A single disk drive very quickly becomes painful, especially if the format is 35 track 
single sided, so it is well worth the effort required to make use of that 40 track double sided drive or drives. 



* Patches Level I 


Ver. 2 


=40 


* CCDisk 


to read, 


write 


=12 


* and format both 


single 


=12 


* and double sided disks 


=12 


t 






=17 


tmode .1 


-pause 




=00 


save /da/ccdisk ccdisk 


=90 


debug 






. ,+3 


Iccdisk 






=5f 


. .+7 






=16 


=80 






=00 


$load /dB/ccdisk 




=81 


Iccdisk 






Iccdisk 


. .+3 






. -+341 


=82 






=a6 


Iccdisk 






=07 


. .+lc9 






=85 


=16 






=01 


=81 






=26 


=84 






=02 


Iccdisk 






=ca 


. .+lf8 






=40 


=5f 






=a6 


=17 






=09 


=01 






=81 


=76 






=15 


Iccdisk 






=16 


. .+2ae 






=ff 


=e6 






=66 


=c9 






=a6 


=00 






=88 


=a9 






=10 


=16 






=85 


=00 






=01 


=8c 






=27 


=12 






=0e 


=23 






=64 


=02 






=e4 


Iccdisk 






=24 


. .+2dd 






=0a 



=c9 

=00 

=a9 

=3a 

=40 

=a7 

=c9 

=00 

=a9 

=35 

=02 

=81 

=15 

=16 

=fe 

=61 

=ea 

=aB 

=22 

=16 

=ff 

=31 

=cb 

=10 

=ea 

=a8 

=22 

=34 

=02 

=17 

=fe 

=f7 

=35 

=02 

=39 

q 

del /d0/ ccdisk 

save /d0/temp ccdisk 

verify u </d0/temp >/d0/ ccdisk 

del temp 

tmode .1 pause 

-t 



The above patch will work on Level 1 version 02.00. 
and format a double sided disk. 



as supplied for the CoCo and will allow CCDisk to read, write 
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The above 15 a shell script, or procedure file if you like, which should be typed in as one long file. Just uork 
down the left column to the bottom and then start at the top of the second, then the right column. The "build" 
coiWTiand could be used to do this, ana of course it will need a filename, CCDisk, patch or nihatever. 

I suggest that a backup of your 35 track boot disk should be used to perfom this patch. Once the file is created 
in the root directory of the backup, simply type CCDisk, patch at the 0S9 prompt, and you should be left with a 
patched CCDisk in the root directory. A new boot disk will then have to be made using the patched version in place 
of the original CCDisk. The new boot disk will have to be a 35 track single sided disk. 

Hottfeveri there is one more step needed. The device descriptors D0, Di etc., mill also need a patch, so that 0S9 
knows they are for double sided drives. At an offset of $19, change the value froiri 1 to 2, and of course, use 
these patched descriptors in your new boot. 

t 

tmode ,i -pause 

save /d0/dl dl 

debug 

Idl 

, .+19 

c 1 2 

q 

del /dfl/dl 

save /d0/temp dl 

verify u </d0/tBap >/d0/dl 

del temp 

tmode ,1 pause 

-t 

Repeat for d0 after changing all the occurrences of '6V to 'd0' 

The above patches will allow the use of double sided 35 track drives giving a total of 70 tracks or 1260 sectors. 
However, the one catch is that the boot disk riiust still be a single sided disk, as the R.S.Dos boot looks for the 
0S9Boot file on track 34 of a single sided drive. 

What happened to the 40 track double sided format you ask? The patched CCDisk now reads the track count, number of 
sides and head step rate from each device descriptor so we can modify the disk descriptors to what we want. 

I modified D0 with the dmode utility and here is the result of a 'cmp' (compare) of the original D0 (#1) and one 
iBodified for double sides and 40 cylinders. 

Differences 

byte #1 #2 The procedure file above patched only one byte at offset 19 he>; from 01 to 02 
====== = = To make the drive descriptor 40 track double sided, follow the example above and change 

00000018 23 23 the values at 18, 2C, 2D, 2E to those in column #2. 
01 02 



ED 9C 
J2D S8 EF 
0000802E 9E C4 
Bytes compared: 0000002F 
Sytes different: 00000005 

Weil I hope that the CCDisk patch will help some Level 1 users. As always, there is a gotcha! Because both 0S9Gen 
and Cobbler are hard coded for 633 sectors, it is not possible (without patching them) to make a successful 40 
track boot disk, I have, however, made a new 35 track, single sided boot disk using the above information, and 
everthing seemed to work fine. I hope to cover some further aspects of this in future newsletters. 



Until next month, Regards, Gordon. 
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A Database in C 
by Sob Devries 

Here new is the saveO function for my C database. This function is passed the record number, and a boolean 
variable to indicate whether to add the record to the end of the file or to replace the current pointed to record. 

You iftay be interested to know that I have been able to ccmpile this programme on my Commodore Amiga with Lattice Ci 
but quite a few modifications had to be made. Mostly it was because the Lattice compiler is much more fussy about 
passing variables to functions, and how pointers are passed. It is also a compiler that adheres to the ANSI 
standard for C compilersi which the 0S9 C compiler does not. And, of course I had to write a new 'ansi.h' file to 
allow for the different screen addressing. 



save (recno, replace) 

int recno; 

int replace; 

/* saveO either saves the data held in the structure in the position of */ 

/* the file pointer^ or at the end of the file depending on whether the */ 

/* variable 'replace' is TRUE (current pos) or FALSE (end of file) fr/ 



long posilof; 
struct address temp? 
int tempreci 
.char ch; 



/* curr pos and last of file pos */ 
/* temp address struct */ 



teraprec = 0; 
f5eek(fPT01,2); 
lof = ftell(fp); 

if (replace == TRUE) /* replace current record */ 
( 

fseek(fPT( long) (recno - l)*sizeof(mail)T0); 
fujrite(&mail,5izeof (mail),l,fp); 



else 



{ /* replace deleted record or seek to eof #.- 

do ! 

temprec++; 

f5eek(fp, (long)(temprec - l)*5izeof(maii)T3); 
pos = fteii(fp); 
if (pos >= lof) 
I 

lastrec += l; 
break ; 
) 
fread(&teniPTsireof(temp)»ljfp); 
ch = temp.5urname[0]; 

f5eek(fPi(long)(temprec - l)*sizeof(mail)|0); 
} while (ch != '\0M; 
recno = (int)ftell(fp)/sizeof(maii)+li 
fwrite(&mail,5i2eof(mail)»l»fp)T 
} 



return (recno)? 
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NATIt^iAL 0S9 USER GROUP APPLICATIiS^ / RBE^ FORM 



[ ] ^iBSCRIPTION leEWAL 



[ 3 f£H SUBSCRIPTION 



Surname 



First Nanie : 



Title (tlroetc) 



Street : 



Suburb 



State ; Postcode : 



Home Phone : 



Business Phone 



Do you run 0S9 Level 1 [__3 and/or 0S9 Level 2 [„3 (please tick) 



Type of Computer for 0S9 



Diskette Size (inches): NuHiber of Tracks: Sides: Number of Drives 



Special Interests : 



Can you contribute articles to this Newsletter ? 



Date : / /. 



Signature :. 



Afffount Enclosed: $ __ 



( $lS-00 will cover you for 12 months) 
(cheques payable to National 0S9 User Sroup) 



NOTE: All current subscriptions Expire AUGUST 3ist, 1989 (Tiiio Year subscribers AU5 1993) 

- Renewals Commence SEPTEMBER 1939 {SEPT 1993) 

Ail current subscribers should now have back-copies from SEPTEMBER 1988 if you are missing any editions 
please note here the missing editions, 

[ ] SEP [ ] OCT [ ] NOV [ 3 DEC [ 1 JAN/FEI. [ 3 flAR [ ] APR [3 HAY [ 3 JUN [ 3 JUL [3 AUG 



Please Return Completed Form to :- 

NATIONM. 089 USER SROUP 
C/o Gordon BEMTZEN 
8 ODIN STREET, 
ffJWYBANK OLD 41(B9 



